<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Text Helper : CodeIgniter User Guide</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv='expires' content='-1' />
<meta http-equiv= 'pragma' content='no-cache' />
<meta name='robots' content='all' />
<meta name='author' content='ExpressionEngine Dev Team' />
<meta name='description' content='CodeIgniter User Guide' />

</head>
<body>
<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Toggle Table of Contents" alt="Toggle Table of Contents" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>CodeIgniter User Guide Version 2.1.0</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">Table of Contents Page</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.com/">CodeIgniter Home</a> &nbsp;&#8250;&nbsp;
<a href="../index.html">User Guide Home</a> &nbsp;&#8250;&nbsp;
Text Helper
</td>
<td id="searchbox"><form method="get" action="http://www.google.com/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.com/user_guide/" />Search User Guide&nbsp; <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />&nbsp;<input type="submit" class="submit" name="sa" value="Go" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->

<br clear="all" />


<!-- START CONTENT -->
<div id="content">


<h1>텍스트처리 Text Helper</h1>

<p>텍스트처리 헬퍼는 텍스트관련작업에 유용한 함수를 포함합니다.</p>


<h2>로딩 Loading this Helper</h2>

<p>다음과같이 헬퍼를 로드합니다:</p>
<code>$this->load->helper('text');</code>

<p>다음 함수들이 사용가능 합니다:</p>


<h2>word_limiter()</h2>

<p>문자열을 지정된 숫자만큼 <strong>단어</strong>단위로 잘라냅니다. 예:</p>

<code>
$string = "Here is a nice text string consisting of eleven words.";<br />
<br />
$string = word_limiter($string, 4);<br /><br />

// Returns:  Here is a nice&#8230;
</code>

<p>세번째 파라미터는 옵션이며 ,문자열 끝에 붙이고 싶은것을 설정합니다.  기본값은 말줄임표 입니다.</p>


<h2>character_limiter()</h2>

<p>문자열을 지정된 <strong>글자</strong>수만큼 잘라냅니다 .이함수는 단어의 완전성 검사를 하기때문에 지정된 숫자보다 조금더 적거나 많게 잘라질수 있습니다.예 :</p>

<code>
$string = "Here is a nice text string consisting of eleven words.";<br />
<br />
$string = character_limiter($string, 20);<br /><br />

// Returns:  Here is a nice text string&#8230;
</code>

<p>세번째 파라미터는 옵션이며 ,문자열 끝에 붙이고 싶은것을 설정합니다.  기본값은 말줄임표 입니다.</p>



<h2>ascii_to_entities()</h2>

<p> high ASCII 나 MS Word 에 쓰이는 문자등 웹페이지에 표시될때 문제가 되는 ASCII 값들을 문자 엔티티로 변경합니다. 그렇게하므로써 브라우저의 설정에 상관없이 일관되게 페이지에 표시할수 있게하거나 신뢰성 있게 데이터베이스에 저장할수 있게 합니다.
이함수는 서버의 문자셋(character sets)에 대한 의존성이 일부 있으므로 , 모든상황에서 100% 신뢰성이 있지는 않습니다만, 대부분의 경우에 잘 작동합니다. 예:</p>

<code>$string = ascii_to_entities($string);</code>


<h2>entities_to_ascii()</h2>

<p>이함수는 바로위에 소개한 함수와 반대로 작동합니다. 이 함수는 엔티티를  ASCII 로 되돌려 줍니다. </p>
<h2>convert_accented_characters()</h2>
  <p>높은 ASCII 문자를 동일한 낮은 ASCII로 변환합니다, 표준 ASCII문자만 허용되는곳에서 영어가 아닌 문자를 사용해야만 할때 
    유용합니다. 예를들어 URL.</p>
  <code>$string = convert_accented_characters($string);</code> 
  <p>이 함수에서 사용되는 변환정보는 <dfn>application/config/foreign_chars.php</dfn> 에 정의 되어 
    있습니다. </p>


<h2>word_censor()</h2>

<p>텍스트문자열에서 특정 단어를 검열합니다.  첫번째 파라미터는 원본문자열입니다.  두번째 파라미터는 검열대상 문자열의 배열입니다.  옵션인 세번째 파라미터는 검열대상문자열을 대신할 문자열입니다.만약 세번째 파라미터를 지정하지않으면  #### 로 변환됩니다.  예:</p>

<code>
$disallowed = array('darn', 'shucks', 'golly', 'phooey');<br />
<br />
$string = word_censor($string, $disallowed, 'Beep!');</code>


<h2>highlight_code()</h2>

<p>문자열에서 소스코드(PHP, HTML, 등.)에 해당하는부분에 색깔을 입힙니다.  예:</p>

<code>$string = highlight_code($string);</code>

<p>이함수는 PHP에 내장된 highlight_string() 함수를 사용하므로 , 색깔은 php.ini 에 지정된것을 사용합니다.</p>


<h2>highlight_phrase()</h2>

<p>문자열에서 문구를 강조할때 씁니다.첫번째 파라미터는 원본문자열이며, 두번째 파라미터는 강조하고자하는 문구입니다.  세번째,네번재 파라미터는 적용하고자 하는 여는태그 및 닫는태그 입니다. 예:</p>

<code>
$string = "Here is a nice text string about nothing in particular.";<br />
<br />
$string = highlight_phrase($string, "nice text", '&lt;span style="color:#990000">', '&lt;/span>');
</code>

<p>위예제는 아래를 리턴합니다:</p>

<p>Here is a <span style="color:#990000">nice text</span> string about nothing in particular.</p>



<h2>word_wrap()</h2>

<p>지정된 글자개수길이만큼으로 감쌉니다(Wraps text). 줄바꿈이 아니라 한줄에 표시될 문자개수를 정해주면 그이상 벗어나지않고 한줄 아래로 내려가는 효과입니다. 예:</p>

<code>$string = "Here is a simple string of text that will help us demonstrate this function.";<br />
<br />
echo word_wrap($string, 25);<br />
<br />
// 위코드의 결과는 아래와 같습니다:<br />
<br />
Here is a simple string<br />
of text that will help<br />
us demonstrate this<br />
function</code>

<h2>ellipsize()</h2>

  <p>이 함수는 문자열에서 태그를 제거하고 지정된 최대 길이로 자른후 생략 기호를 삽입합니다.</p>
  <p>첫번째 파라미터는 대상문자열, 두번째는 문자열 길이,세번째는 생략기호가 어디에 붙어야할지 결정합니다. 예를들어 1은 생략기호를 문자열의 
    오른쪽에 붙이고, .5는 중간,0은 왼쪽에 붙입니다..</p>
  <p>옵션인 네번째 파라미터는 생략기호 입니다.기본값은 <samp>...</samp> 입니다.</p>

<code>$str = 'this_string_is_entirely_too_long_and_might_break_my_design.jpg';<br />
<br />
  echo ellipsize($str, 32, .5);</code> 결과: <code>this_string_is_e&hellip;ak_my_design.jpg</code> 
</div>
<!-- END CONTENT -->


<div id="footer">
<p>
Previous Topic:&nbsp;&nbsp;<a href="string_helper.html">String Helper</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">Top of Page</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">User Guide Home</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
Next Topic:&nbsp;&nbsp;<a href="typography_helper.html">Typography Helper</a>
</p>
<p><a href="http://codeigniter.com">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">Ellislab, Inc.</a></p>
</div>

</body>
</html>